home *** CD-ROM | disk | FTP | other *** search
/ Risc World 7 / Risc World 7.iso / Software / Issue2 / SDL.ARC / !gcc / include / unixlib / resolv / h / resolv
Encoding:
Text File  |  2004-09-05  |  14.7 KB  |  412 lines
  1. /****************************************************************************
  2.  *
  3.  * $Source: /usr/local/cvsroot/gccsdk/unixlib/source/clib/resolv/resolv.h,v $
  4.  * $Date: 2002/12/22 18:22:28 $
  5.  * $Revision: 1.1 $
  6.  * $State: Exp $
  7.  * $Author: admin $
  8.  *
  9.  ***************************************************************************/
  10.  
  11. /*
  12.  * File taken from glibc 2.2.5.
  13.  * Following changes were made:
  14.  *  - Declare _res and don't prefix the declared function names with one
  15.  *    or more underscores.
  16.  *  - Changed type struct __res_state._u._ext.nsaddrs to struct sockaddr_in
  17.  *    when _LIBC is not defined.
  18.  *  - Changed "/etc/resolv.conf" into "InetDBase:resolv.conf".
  19.  */
  20.  
  21. /*
  22.  * Copyright (c) 1983, 1987, 1989
  23.  *    The Regents of the University of California.  All rights reserved.
  24.  *
  25.  * Redistribution and use in source and binary forms, with or without
  26.  * modification, are permitted provided that the following conditions
  27.  * are met:
  28.  * 1. Redistributions of source code must retain the above copyright
  29.  *    notice, this list of conditions and the following disclaimer.
  30.  * 2. Redistributions in binary form must reproduce the above copyright
  31.  *    notice, this list of conditions and the following disclaimer in the
  32.  *    documentation and/or other materials provided with the distribution.
  33.  * 4. Neither the name of the University nor the names of its contributors
  34.  *    may be used to endorse or promote products derived from this software
  35.  *    without specific prior written permission.
  36.  *
  37.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  38.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  39.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  40.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  41.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  42.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  43.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  44.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  45.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  46.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  47.  * SUCH DAMAGE.
  48.  */
  49.  
  50. /*
  51.  * Portions Copyright (c) 1996-1999 by Internet Software Consortium.
  52.  *
  53.  * Permission to use, copy, modify, and distribute this software for any
  54.  * purpose with or without fee is hereby granted, provided that the above
  55.  * copyright notice and this permission notice appear in all copies.
  56.  *
  57.  * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
  58.  * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
  59.  * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
  60.  * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  61.  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  62.  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
  63.  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  64.  * SOFTWARE.
  65.  */
  66.  
  67. /*
  68.  *    @(#)resolv.h    8.1 (Berkeley) 6/2/93
  69.  *    $BINDId: resolv.h,v 8.31 2000/03/30 20:16:50 vixie Exp $
  70.  */
  71.  
  72. #ifndef _RESOLV_H_
  73. #define    _RESOLV_H_
  74.  
  75. #include <sys/param.h>
  76. #if (!defined(BSD)) || (BSD < 199306)
  77. # include <sys/bitypes.h>
  78. #else
  79. # include <sys/types.h>
  80. #endif
  81. #include <unixlib/features.h>
  82. #include <stdio.h>
  83.  
  84. #include <netinet/in.h>
  85. #include <arpa/nameser.h>
  86.  
  87. /*
  88.  * Revision information.  This is the release date in YYYYMMDD format.
  89.  * It can change every day so the right thing to do with it is use it
  90.  * in preprocessor commands such as "#if (__RES > 19931104)".  Do not
  91.  * compare for equality; rather, use it to determine whether your resolver
  92.  * is new enough to contain a certain feature.
  93.  */
  94.  
  95. #define    __RES    19991006
  96.  
  97. /*
  98.  * Resolver configuration file.
  99.  * Normally not present, but may contain the address of the
  100.  * inital name server(s) to query and the domain search list.
  101.  */
  102.  
  103. #ifndef _PATH_RESCONF
  104. #define _PATH_RESCONF        "InetDBase:resolv.conf"
  105. #endif
  106.  
  107. typedef enum { res_goahead, res_nextns, res_modified, res_done, res_error }
  108.     res_sendhookact;
  109.  
  110. typedef res_sendhookact (*res_send_qhook) (struct sockaddr_in * const *ns,
  111.                        const u_char **query,
  112.                        int *querylen,
  113.                        u_char *ans,
  114.                        int anssiz,
  115.                        int *resplen);
  116.  
  117. typedef res_sendhookact (*res_send_rhook) (const struct sockaddr_in *ns,
  118.                        const u_char *query,
  119.                        int querylen,
  120.                        u_char *ans,
  121.                        int anssiz,
  122.                        int *resplen);
  123.  
  124. struct res_sym {
  125.     int    number;        /* Identifying number, like T_MX */
  126.     char *    name;        /* Its symbolic name, like "MX" */
  127.     char *    humanname;    /* Its fun name, like "mail exchanger" */
  128. };
  129.  
  130. /*
  131.  * Global defines and variables for resolver stub.
  132.  */
  133. #define    MAXNS            3    /* max # name servers we'll track */
  134. #define    MAXDFLSRCH        3    /* # default domain levels to try */
  135. #define    MAXDNSRCH        6    /* max # domains in search path */
  136. #define    LOCALDOMAINPARTS    2    /* min levels in name that is "local" */
  137.  
  138. #define    RES_TIMEOUT        5    /* min. seconds between retries */
  139. #define    MAXRESOLVSORT        10    /* number of net to sort on */
  140. #define    RES_MAXNDOTS        15    /* should reflect bit field size */
  141. #define    RES_MAXRETRANS        30    /* only for resolv.conf/RES_OPTIONS */
  142. #define    RES_MAXRETRY        5    /* only for resolv.conf/RES_OPTIONS */
  143. #define    RES_DFLRETRY        2    /* Default #/tries. */
  144. #define    RES_MAXTIME        65535    /* Infinity, in milliseconds. */
  145.  
  146. struct __res_state {
  147.     int    retrans;         /* retransmition time interval */
  148.     int    retry;            /* number of times to retransmit */
  149.     u_long    options;        /* option flags - see below. */
  150.     int    nscount;        /* number of name servers */
  151.     struct sockaddr_in
  152.         nsaddr_list[MAXNS];    /* address of name server */
  153. #define    nsaddr    nsaddr_list[0]        /* for backward compatibility */
  154.     u_short    id;            /* current message id */
  155.     char    *dnsrch[MAXDNSRCH+1];    /* components of domain to search */
  156.     char    defdname[256];        /* default domain (deprecated) */
  157.     u_long    pfcode;            /* RES_PRF_ flags - see below. */
  158.     unsigned ndots:4;        /* threshold for initial abs. query */
  159.     unsigned nsort:4;        /* number of elements in sort_list[] */
  160.     char    unused[3];
  161.     struct {
  162.         struct in_addr    addr;
  163.         u_int32_t    mask;
  164.     } sort_list[MAXRESOLVSORT];
  165.     res_send_qhook qhook;        /* query hook */
  166.     res_send_rhook rhook;        /* response hook */
  167.     int    res_h_errno;        /* last one set for this context */
  168.     int    _vcsock;        /* PRIVATE: for res_send VC i/o */
  169.     u_int    _flags;            /* PRIVATE: see below */
  170.     union {
  171.         char    pad[52];    /* On an i386 this means 512b total. */
  172.         struct {
  173.             u_int16_t        nscount;
  174.             u_int16_t        nstimes[MAXNS];    /* ms. */
  175.             int            nssocks[MAXNS];
  176.             u_int16_t        nscount6;
  177.             u_int16_t        nsinit;
  178. #ifdef _LIBC
  179.             struct sockaddr_in6    *nsaddrs[MAXNS];
  180. #else
  181.                         struct sockaddr_in    *nsaddrs[MAXNS];
  182. #endif
  183.         } _ext;
  184.     } _u;
  185. };
  186.  
  187. typedef struct __res_state *res_state;
  188.  
  189. /*
  190.  * Resolver flags (used to be discrete per-module statics ints).
  191.  */
  192. #define    RES_F_VC    0x00000001    /* socket is TCP */
  193. #define    RES_F_CONN    0x00000002    /* socket is connected */
  194.  
  195. /* res_findzonecut() options */
  196. #define    RES_EXHAUSTIVE    0x00000001    /* always do all queries */
  197.  
  198. /*
  199.  * Resolver options (keep these in synch with res_debug.c, please)
  200.  */
  201. #define RES_INIT    0x00000001    /* address initialized */
  202. #define RES_DEBUG    0x00000002    /* print debug messages */
  203. #define RES_AAONLY    0x00000004    /* authoritative answers only (!IMPL)*/
  204. #define RES_USEVC    0x00000008    /* use virtual circuit */
  205. #define RES_PRIMARY    0x00000010    /* query primary server only (!IMPL) */
  206. #define RES_IGNTC    0x00000020    /* ignore trucation errors */
  207. #define RES_RECURSE    0x00000040    /* recursion desired */
  208. #define RES_DEFNAMES    0x00000080    /* use default domain name */
  209. #define RES_STAYOPEN    0x00000100    /* Keep TCP socket open */
  210. #define RES_DNSRCH    0x00000200    /* search up local domain tree */
  211. #define    RES_INSECURE1    0x00000400    /* type 1 security disabled */
  212. #define    RES_INSECURE2    0x00000800    /* type 2 security disabled */
  213. #define    RES_NOALIASES    0x00001000    /* shuts off HOSTALIASES feature */
  214. #define    RES_USE_INET6    0x00002000    /* use/map IPv6 in gethostbyname() */
  215. #define RES_ROTATE    0x00004000    /* rotate ns list after each query */
  216. #define    RES_NOCHECKNAME    0x00008000    /* do not check names for sanity. */
  217. #define    RES_KEEPTSIG    0x00010000    /* do not strip TSIG records */
  218. #define    RES_BLAST    0x00020000    /* blast all recursive servers */
  219.  
  220. #define RES_DEFAULT    (RES_RECURSE | RES_DEFNAMES | RES_DNSRCH)
  221.  
  222. /*
  223.  * Resolver "pfcode" values.  Used by dig.
  224.  */
  225. #define RES_PRF_STATS    0x00000001
  226. #define RES_PRF_UPDATE    0x00000002
  227. #define RES_PRF_CLASS   0x00000004
  228. #define RES_PRF_CMD    0x00000008
  229. #define RES_PRF_QUES    0x00000010
  230. #define RES_PRF_ANS    0x00000020
  231. #define RES_PRF_AUTH    0x00000040
  232. #define RES_PRF_ADD    0x00000080
  233. #define RES_PRF_HEAD1    0x00000100
  234. #define RES_PRF_HEAD2    0x00000200
  235. #define RES_PRF_TTLID    0x00000400
  236. #define RES_PRF_HEADX    0x00000800
  237. #define RES_PRF_QUERY    0x00001000
  238. #define RES_PRF_REPLY    0x00002000
  239. #define RES_PRF_INIT    0x00004000
  240. /*            0x00008000    */
  241.  
  242. /* UNIXLIB FIX */
  243. #if 1
  244. extern struct __res_state _res;
  245. #else
  246. /* Things involving an internal (static) resolver context. */
  247. #if !defined _LIBC || defined _LIBC_REENTRANT
  248. __BEGIN_DECLS
  249. extern struct __res_state *__res_state(void) __attribute__ ((__const__));
  250. __END_DECLS
  251. #define _res (*__res_state())
  252. #else
  253. #ifndef __BIND_NOSTATIC
  254. extern struct __res_state _res;
  255. #endif
  256. #endif
  257.  
  258. #ifndef __BIND_NOSTATIC
  259. #define fp_nquery        __fp_nquery
  260. #define fp_query        __fp_query
  261. #define hostalias        __hostalias
  262. #define p_query            __p_query
  263. #define res_close        __res_close
  264. #define res_init        __res_init
  265. #define res_isourserver        __res_isourserver
  266. #define res_mkquery        __res_mkquery
  267. #define res_query        __res_query
  268. #define res_querydomain        __res_querydomain
  269. #define res_search        __res_search
  270. #define res_send        __res_send
  271. #endif
  272. #endif
  273.  
  274. __BEGIN_DECLS
  275. void        fp_nquery __P((const u_char *, int, FILE *));
  276. void        fp_query __P((const u_char *, FILE *));
  277. const char *    hostalias __P((const char *));
  278. void        p_query __P((const u_char *));
  279. void        res_close __P((void));
  280. int        res_init __P((void));
  281. int        res_isourserver __P((const struct sockaddr_in *));
  282. int        res_mkquery __P((int, const char *, int, int, const u_char *,
  283.                  int, const u_char *, u_char *, int));
  284. int        res_query __P((const char *, int, int, u_char *, int));
  285. int        res_querydomain __P((const char *, const char *, int, int,
  286.                      u_char *, int));
  287. int        res_search __P((const char *, int, int, u_char *, int));
  288. int        res_send __P((const u_char *, int, u_char *, int));
  289. __END_DECLS
  290.  
  291. #if !defined(SHARED_LIBBIND) || defined(LIB)
  292. /*
  293.  * If libbind is a shared object (well, DLL anyway)
  294.  * these externs break the linker when resolv.h is
  295.  * included by a lib client (like named)
  296.  * Make them go away if a client is including this
  297.  *
  298.  */
  299. extern const struct res_sym __p_key_syms[];
  300. extern const struct res_sym __p_cert_syms[];
  301. extern const struct res_sym __p_class_syms[];
  302. extern const struct res_sym __p_type_syms[];
  303. extern const struct res_sym __p_rcode_syms[];
  304. #endif /* SHARED_LIBBIND */
  305.  
  306. /* UNIXLIB FIX */
  307. #if 0
  308. #define b64_ntop        __b64_ntop
  309. #define b64_pton        __b64_pton
  310. #define dn_comp            __dn_comp
  311. #define dn_count_labels        __dn_count_labels
  312. #define dn_expand        __dn_expand
  313. #define dn_skipname        __dn_skipname
  314. #define fp_resstat        __fp_resstat
  315. #define loc_aton        __loc_aton
  316. #define loc_ntoa        __loc_ntoa
  317. #define p_cdname        __p_cdname
  318. #define p_cdnname        __p_cdnname
  319. #define p_class            __p_class
  320. #define p_fqname        __p_fqname
  321. #define p_fqnname        __p_fqnname
  322. #define p_option        __p_option
  323. #define p_secstodate        __p_secstodate
  324. #define p_section        __p_section
  325. #define p_time            __p_time
  326. #define p_type            __p_type
  327. #define p_rcode            __p_rcode
  328. #define putlong            __putlong
  329. #define putshort        __putshort
  330. #define res_dnok        __res_dnok
  331. #define res_hnok        __res_hnok
  332. #define res_hostalias        __res_hostalias
  333. #define res_mailok        __res_mailok
  334. #define res_nameinquery        __res_nameinquery
  335. #define res_nclose        __res_nclose
  336. #define res_ninit        __res_ninit
  337. #define res_nmkquery        __res_nmkquery
  338. #define res_npquery        __res_npquery
  339. #define res_nquery        __res_nquery
  340. #define res_nquerydomain    __res_nquerydomain
  341. #define res_nsearch        __res_nsearch
  342. #define res_nsend        __res_nsend
  343. #define res_nisourserver    __res_nisourserver
  344. #define res_ownok        __res_ownok
  345. #define res_queriesmatch    __res_queriesmatch
  346. #define res_randomid        __res_randomid
  347. #define sym_ntop        __sym_ntop
  348. #define sym_ntos        __sym_ntos
  349. #define sym_ston        __sym_ston
  350. #endif
  351.  
  352. __BEGIN_DECLS
  353. int        res_hnok __P((const char *));
  354. int        res_ownok __P((const char *));
  355. int        res_mailok __P((const char *));
  356. int        res_dnok __P((const char *));
  357. int        sym_ston __P((const struct res_sym *, const char *, int *));
  358. const char *    sym_ntos __P((const struct res_sym *, int, int *));
  359. const char *    sym_ntop __P((const struct res_sym *, int, int *));
  360. int        b64_ntop __P((u_char const *, size_t, char *, size_t));
  361. int        b64_pton __P((char const *, u_char *, size_t));
  362. int        loc_aton __P((const char *ascii, u_char *binary));
  363. const char *    loc_ntoa __P((const u_char *binary, char *ascii));
  364. int        dn_skipname __P((const u_char *, const u_char *));
  365. void        putlong __P((u_int32_t, u_char *));
  366. void        putshort __P((u_int16_t, u_char *));
  367. const char *    p_class __P((int));
  368. const char *    p_time __P((u_int32_t));
  369. const char *    p_type __P((int));
  370. const char *    p_rcode __P((int));
  371. const u_char *    p_cdnname __P((const u_char *, const u_char *, int, FILE *));
  372. const u_char *    p_cdname __P((const u_char *, const u_char *, FILE *));
  373. const u_char *    p_fqnname __P((const u_char *cp, const u_char *msg,
  374.                    int, char *, int));
  375. const u_char *    p_fqname __P((const u_char *, const u_char *, FILE *));
  376. const char *    p_option __P((u_long option));
  377. char *        p_secstodate __P((u_long));
  378. int        dn_count_labels __P((const char *));
  379. int        dn_comp __P((const char *, u_char *, int,
  380.                  u_char **, u_char **));
  381. int        dn_expand __P((const u_char *, const u_char *, const u_char *,
  382.                    char *, int));
  383. u_int        res_randomid __P((void));
  384. int        res_nameinquery __P((const char *, int, int,
  385.                      const u_char *, const u_char *));
  386. int        res_queriesmatch __P((const u_char *, const u_char *,
  387.                       const u_char *, const u_char *));
  388. const char *    p_section __P((int section, int opcode));
  389. /* Things involving a resolver context. */
  390. int        res_ninit __P((res_state));
  391. int        res_nisourserver __P((const res_state,
  392.                       const struct sockaddr_in *));
  393. void        fp_resstat __P((const res_state, FILE *));
  394. void        res_npquery __P((const res_state, const u_char *, int, FILE *));
  395. const char *    res_hostalias __P((const res_state, const char *,
  396.                    char *, size_t));
  397. int        res_nquery __P((res_state,
  398.                 const char *, int, int, u_char *, int));
  399. int        res_nsearch __P((res_state, const char *, int,
  400.                  int, u_char *, int));
  401. int        res_nquerydomain __P((res_state,
  402.                       const char *, const char *, int, int,
  403.                       u_char *, int));
  404. int        res_nmkquery __P((res_state,
  405.                   int, const char *, int, int, const u_char *,
  406.                   int, const u_char *, u_char *, int));
  407. int        res_nsend __P((res_state, const u_char *, int, u_char *, int));
  408. void        res_nclose __P((res_state));
  409. __END_DECLS
  410.  
  411. #endif /* !_RESOLV_H_ */
  412.